三债传导链
意图债 → 认知债 → 技术债:Why 丢失、Reasoning 瓦解、How 腐烂——三债交织成 System Health 的衰退链。
意图债 → 认知债
Why 消失
当系统的初衷与约束没被记录,团队只能靠观察代码"猜谜"。
- 文档债务:架构决策散落在 PR / Slack / 个人记忆里
- 共同理解的蒸发速度 > 补充速度
- 无法识别原始约束 → 不敢做大胆假设
- 心理模型碎片化,Reasoning 链中断
认知债 → 技术债
Reasoning 瓦解
想不通就不敢改,不敢改就只能乱写——补丁式编程把认知风险固化进代码。
- 复杂函数无人重构,外面再包一层
if-else
- 复制粘贴 + 微调,重复与耦合扩散
- 为规避风险做的折中 → 沉淀为代码混乱
- "想不通 → 不敢改 → 乱写" 循环成型
技术债 → 恶性循环
How 腐烂
凌乱代码反过来掩盖业务意图、放大认知负荷,三债互相滋养。
- 掩盖意图:真实 Why 更难被识别
- 认知负荷呈指数级上升
- 系统健康(System Health)持续被削弱
- "删掉它,半个城市的订单就挂了"
⚡
AI 加速器效应
生成快 · 丢得快 · 乱得快
Copilot / Cursor 写 How 飞快,但 Why 流失更快、认知债爆发更猛、没人敢系统性重构。
🎯
架构师的最高杠杆点
先补意图,再降认知,最后才动代码
ADR 记录 Why · 验收标准即文档 · 普适语言 · 共享心理模型 · 嵌入团队日常活动。